home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / chat / ircii-2.8he / ircii-2 / help / EXEC < prev    next >
Encoding:
Text File  |  1993-05-20  |  3.8 KB  |  88 lines
  1. Usage: EXEC <shell commands>
  2.        EXEC -NAME <name> <shell commands>
  3.        EXEC -OUT [%<process id>|<shell commands]
  4.        EXEC -MSG <nickname> [%<process id>|<shell commands>]
  5.        EXEC -NOTICE <nickname> [%<pocess id>|<shell commands>]
  6.        EXEC -IN %<process id> <text to send to process>
  7.        EXEC -WINDOW [%<process id>|<shell commands>]
  8.        EXEC -<signal> %<process id>
  9.        EXEC -CLOSE %<process id>
  10.  
  11.   EXEC allows you to start subprocesses in ircII and manipulate
  12.   them in various ways.  You can start multiple subprocesses
  13.   simultaneously and access them via a process number assigned
  14.   by ircII.  You can list all currently running subprocesses by
  15.   using EXEC with no parameters.  The process id of a process
  16.   is the number assigned by ircII for that process, or the 
  17.   name of the process given by the -NAME flag.  If a NAME is 
  18.   given to a process, that name may be used anyway in place of
  19.   the process number assigned by ircII.
  20.  
  21.   The first form of EXEC will simply start a subprocess and send
  22.   it's output to your display.
  23.  
  24.   The second form tells IRCII to send the output of the process
  25.   to your current channel.  For example:
  26.     EXEC -OUT ls
  27.   sends the output of ls to your channel.  
  28.     EXEC -OUT %1
  29.   tells ircII to send the output of subprocess 1 to your channel.
  30.   Subprocess 1 must exist already by a previous call to EXEC.
  31.  
  32.   The third form is much like the second, except that it sends
  33.   to the specified nickname or nicknames (the format of the
  34.   nicknames is the same as for MSG).  As with the second form,
  35.   you can start a subprocess with -MSG, or you can change an
  36.   already running process to send it's output to the given nicknames.
  37.  
  38.   The fourth form is identical to the first, except the messages
  39.   are send as NOTICEs not as PRIVMSG's.
  40.  
  41.   The fifth form lets you send a line of input to a running
  42.   subprocess.  For example:
  43.     EXEC -IN %shell This is a test.
  44.   Sends "This is a test." to subprocess 0.  This processes must
  45.   have previously been started with a call to EXEC -NAME shell. 
  46.   An alternate method of sending text to processes is using the 
  47.   MSG or QUERY command.  In the place of a nickname, you may 
  48.   specify %n, when  n is a current running processes id.   For 
  49.   example:
  50.     MSG %shell This is a test.
  51.   is equivalent to the previous example.
  52.  
  53.   The sixth form lets you specify that you want all output from
  54.   the process to go to the current window.  Normally, output
  55.   from processes goes to whichever window has a level setting of
  56.   CRAP.  This locks the output into the current window.  
  57.     EXEC -WINDOW %1
  58.   Sends the output of process 1 to the current window.
  59.  
  60.   The last form lets you send various signals to subprocesses.
  61.   The allowable signals are:
  62.     HUP     INT     QUIT     ILL     TRAP     IOT     EMT
  63.     FPE     KILL    BUS      SEGV    SYS      PIPE    ALRM
  64.     TERM    URG     STOP     TSTP    CONT     CHLD    TTIN
  65.     TTOU    IO      XCPU     XFSZ    VTALRM   PROF    WINCH
  66.     LOST    USR1    USR2
  67.   What these signals do depends on the process running, etc.
  68.     EXEC -KILL %0
  69.   Sends a KILL signal to process 0, forcing it to exit
  70.   immediately.  If you want to read more about these signals, do
  71.   a "man kill" at your shell prompt.
  72.  
  73.   The last form is for really ornery processes that simply won't
  74.   die.  Sometimes this is because an EXEC'd process has forked
  75.   off subprocesses which don't die when you use -KILL (or other
  76.   flag).  Doing a:
  77.     EXEC -CLOSE %0
  78.   closes all of ircII's connections to that processes.  This means 
  79.   that even if the processes is still sending output you won't see
  80.   it.  This also means (in most cases) that the process will be
  81.   killed by a SIGPIPE when it tries to send to ircII.
  82.  
  83. See Also: 
  84.   SET SHELL
  85.   SET SHELL_FLAGS
  86.   SET SHELL_LIMIT
  87.   SET NOTIFY_ON_TERMINATION    
  88.